home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / misc / sexehead.lha / SEXeHeader.doc < prev    next >
Text File  |  1995-09-24  |  6KB  |  160 lines
  1. SEXeHeader V2.0
  2.  
  3. MS Windows (Bindoze) New Executable (NE) header reader
  4.  
  5. ©Copyright 1995 Soyeb Aswat
  6.  
  7. FreeWare
  8.  
  9. 22/9/95
  10.  
  11.  
  12.  
  13. Introduction
  14.  
  15. SEXeHeader is the first stage in a project I am working on which will culminate in a 
  16. program that will allow you to run a MS Windows application on your Amiga as if it 
  17. were made for AmigaOS originally. This is with all the Amiga's wonderful multitask-
  18. ing abilities and without the Windows resource hogging!
  19.  
  20. The next stage of this project is an 80386 dissasembler which will dissasemble 
  21. Windows NE executable files and dynamic link libraries (DLL). This will be followed 
  22. by the actual emulator to run Windows programs.
  23.  
  24.  
  25. Requirements
  26.  
  27. An Amiga!
  28. Workbench 2.04
  29.  
  30. Usage
  31.  
  32.     SEXeHeader Name/A STDIO/S
  33.  
  34. Stdio switch is to allow you to output the information on shell window enabling output 
  35. redirection to a file.
  36.  
  37.  
  38. What does it do!
  39.  
  40. SEXeHeader takes a Windows executable or library file as input and displays it's 
  41. header details in an understandable manner. In other words it looks at the details the 
  42. linker has put in the file to tell the loader how to load and run it. Some very interest-
  43. ing things can be found in this data.
  44.  
  45.  
  46. Why do it?
  47.  
  48. Why have a program to look at Windows files on an Amiga I hear you ask. Well as 
  49. can be seen from the introduction I am working on a Windows emulator, *not* a PC 
  50. emulator but a Windows emulator. To do this I have to decipher Microsoft ducumen-
  51. tation which is very ambiguous, confusing and has great omissions.
  52.  
  53. The best way to find this out in my opinion was to write my own program to do some-
  54. thing and compare the output to a similar program already available. SEXeHeader's 
  55. output was compared to Turbo Dump from Borland, Mapwin from PharLap 
  56. Technologies and EXEdump from the writers of Undocumented Windows. The dis-
  57. sasemblers output will be compared to similar dissasemblers I have in my posession 
  58. on the PC and the final emulator will be compared to Windows itself!
  59.  
  60. From making SEXeHeader I was able to clear up much of the confusion and ommi-
  61. sions I found in the Microsoft ducumentation for the Windows NE file format.
  62.  
  63.  
  64. Future
  65.  
  66. I will continue to develop this program as much as I need so don't expect new 
  67. versions. I have included the source for all to ogle at and improve on.
  68.  
  69.  
  70. Bugs
  71.  
  72. None that I have found but I am sure there are some. Send me a detailed description 
  73. of the bug describing your system, programs running etc, and preferably a copy of 
  74. the file that caused the problem to show up.
  75.  
  76. NOTE
  77.  
  78. If you make any improvements or bug fixes please send them to me FIRST do not 
  79. release any "improved" versions. This is not to oppress your creativity but to allow 
  80. the currently available version of SEXeHeader to be the best available. This also 
  81. stops some versions having features that others don't etc.
  82.     All improvements made by you will be fully credited.
  83.  
  84.  
  85. Windows emulator
  86.  
  87. If you are interested in any of my future projects please send me some mail to let me 
  88. know. Depending on the amount of interest shown I will put effort into producing the 
  89. software.
  90.  
  91.  
  92. Author
  93.  
  94. Soyeb Aswat
  95. 37 Newick Road,
  96. Clapton,
  97. London,
  98. E5 0RP,
  99. UK.
  100.  
  101. e-mail: df114@city.ac.uk
  102.  
  103. If you use this program or even just download it out of curiosity (catchy name isn't it!) 
  104. send me an e-mail or a postcard or something so I know if anybody's out there! If 
  105. you have any questions comments bug reports or just want somebody to talk to write 
  106. to me.
  107.  
  108.  
  109. Liscence
  110.  
  111. This program can be freely distributed on the condition that the archive stays in its 
  112. original form. No modifications are made to the program, documentation and associ-
  113. ated files. The source is provided for reference only and is not intended to reflect the 
  114. operation of the provided executable.
  115.     You may change and recompile the source to your specifications but I shall 
  116. retain the copyright on this and any subsequent versions of the program  and will be 
  117. subject to the conditions above. Any improvements made should be sent to me and 
  118. if included in following software, improvements will be fully credited to you. Under no 
  119. circumstances should adjusted copies be distributed without my prior consent.
  120.     No gurantees are made as to the suitability, functionality or accuracy of the 
  121. software to any purpose whatsoever. No guarantee is made to the accuracy of the 
  122. documentation as relating to the software or otherwise.
  123.     No resposibility is taken for damages caused through the use or misuse of the 
  124. program of any sort whatsoever whether direct or consequential, whether physical, 
  125. financial or any other form.
  126.  
  127.  
  128. References
  129.  
  130. Microsoft Windows 3.1 Programmer's reference Volume 4
  131. Microsoft Press    ISBN: 1-55615-494-1
  132. Contains the NE file format among many others. Typical Microsoft documentation, 
  133. confusing and containing many omissions, only there to keep the lawyers happy and 
  134. stop themfrom being investigated for monopolising. Despite all this absolutely essen-
  135. tial.
  136.  
  137. Microsoft Windows 3.1 Guide to programming
  138. Microsoft Press    ISBN:
  139. As above. Best thing is to get the complete set of programmers reference guides 
  140. which are available with the Microsoft Windows 3.1 Software Development Kit (SDK) 
  141. Probably be hard to get hold of now but if you have a copy PLEASE TELL ME!!!!!!
  142.  
  143. Undocumented Windows : a programmer's guide to reserved Microsoft Windows API 
  144. functions
  145. by Andrew Schulman, David Maxey, Matt Pietrek
  146. Addison-Wesley    ISBN: 0-201-60834-0
  147. Invaluable source of information for insulting Windows, also contains many usful de-
  148. scriptions of both documented and undocumented functions etc.
  149.  
  150.  
  151. History
  152.  
  153. 1.0    19/9/95    First version, works on any Amiga
  154.  
  155. 2.0    22/9/95    Revised version which opens its own output window unless
  156.             specfically instructed not to, useful for redirecting output to a file.
  157.             Proper command line parsing courtesy of ReadArgs function.
  158.             Ctrl-C support added.
  159.             Named version 2.0 due to the requirement of Workbench 2.0
  160.